KDDIクラウドプラットフォームサービス ナレッジサイト

  • HOME
  • 開発者ガイドブック(APIリファレンス)
  • オブジェクトストレージ
  • サービス操作
  • オブジェクト操作
  • Initiate Multipart Upload

Initiate Multipart Upload

処理概要

POST Initiate Multipart Uploadは、マルチパートアップロードを開始しアップロードIDを返します。アップロードIDは一意のマルチパートアップロードに紐付いたすべてのパーツに対して使用します。パーツアップロード毎にこのアップロードIDを指定します。一番最後のリクエスト（マルチパート完了、マルチパート中断）にも利用します。

リクエスト

リクエストパラメタ

なし

リクエストヘッダー

Name Type Description Required
Cache-Control – 使用不可 No
Content-_Disposition – 使用不可 No
Content-Encoding string objectに適用されたコンテント・エンコーディングを指定することで、デコード処理がContent-Typeヘッダーを参照してメディアタイプを決めます。詳細はこちらを参照してください。 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11. No
Content-Type string objectのデータに対して標準MIME種別を記述します。
詳細はこちらを参照してください。 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17.		 No
Expires – 使用不可 No
x-amz-meta-* string この接頭辞で始まるヘッダーはユーザー定義メタデータです。それぞれKey-Valueペアで扱います。S3はユーザー定義メタデータに対して検証や解釈を行いません。詳しい説明は、PUT Objectを参照してください。 No
x-amz-storage-_class – 使用不可 No
x-amz-website_-redirect-location – 使用不可 No
x-amz-acl string HeaderによるACL設定時に指定。private / public-readなど。詳細はこちらを参照。
※public-read-write / authenticated-read / bucket-owner-read / bucket-owner-full-controlは非対応		 No
x-amz-grant-read string HeaderによるACL設定時に指定。
・id=<UUID>
・emailAddres=<username>
(API仕様上メールアドレスではなくUsernameで指定)
・uri=< Amazon’s pre-defined groups.>		 No
x-amz-grant-read-acp string No
x-amz-grant-write-acp string No
x-amz-grant-full-control string No

リクエストボディ

なし

リクエストサンプル

POST /sample-bucket/sample-object.txt?uploads HTTP/1.1
Host: 192.168.0.1
Connection: keep-alive
Date: Fri, 07 Aug 2015 15:12:30 +0000
Authorization: AWS EXAMPLEjU2So5By3H5v2:EXAMPLEAjwlAvEi2cPLfQaM588ROWW90so7LwfPr

レスポンス

レスポンスヘッダ

このオペレーションはすべての操作に共通するレスポンスヘッダのみを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。

レスポンスボディ

Name Type Description
InitiateMultipartUploadResult container レスポンスコンテナ
Bucket string マルチパートアップロードを開始したbucket名
Key string マルチパートアップロードを開始したobjectのキー名
UploadId string マルチパートアップロードID 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>string</Bucket>
    <Key>string</Key>
    <UploadId>string</UploadId>
</InitiateMultipartUploadResult>

レスポンスサンプル

HTTP/1.1 200 OK
Date: Tue, 01 Sep 2015 10:00:00 GMT
X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef
Server: Cleversafe/3.5.1.0
X-Clv-S3-Version: 2.4
x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 281
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Bucket>sample-bucket</Bucket>
    <Key>sample-object.txt</Key>
    <UploadId>12345678-9abc-def0-1234-56789abcdef0</UploadId>
</InitiateMultipartUploadResult>
2024/09/15 2024/09/15